



ASCII CODES 






CODE 


CHAR 


CODE 


CHAR 


CODE 


CHAR 


00 


NUL 


2B 


+ 


96 


V 


01 


SOH 


2C 




57 


W 


02 


STX 


2D 


- 


58 


X 


03 


ETX 


2E 




59 


Y 


04 


EOT 


2F 


/ 


5A 


Z 


05 


ENQ 


30 





5B 


[ 


06 


ACK 


31 


1 


5C 


\ 


07 


BEL 


32 


2 


5D 


] 


08 


BS 


33 


3 


5E 


A 


09 


HT 


34 


4 


5F 




0A 


LF 


35 


5 


60 




OB 


VT 


36 


6 


61 


a 


OC 


FF 


37 


7 


62 


b 


OD 


CR 


38 


8 


63 


c 


OE 


SO 


39 


9 


64 


d 


OF 


SI 


3A 




65 


e 


10 


DLE 


3B 




66 


f 


11 


DC1 


3C 


< 


67 


g 


12 


DC2 


3D 


= 


68 


h 


13 


DC3 


3E 


> 


69 


i 


14 


DC4 


3F 


? 


6A 


j 


15 


NAK 


40 


@ 


6B 


k 


16 


SYN 


41 


A 


6C 


I 


17 


ETB 


42 


B 


6D 


m 


18 


CAN 


43 


C 


6E 


n 


19 


EM 


44 


D 


6F 





1A 


SUB 


45 


E 


70 


p 


1B 


ESC 


46 


F 


71 


q 


1C 


FS 


47 


G 


72 


r 


1D 


GS 


48 


H 


73 


s 


1E 


RS 


49 


I 


74 


t 


1F 


US 


4A 


J 


75 


u 


20 


SP 


4B 


K 


76 


V 


21 


I 


4C 


L 


77 


w 


22 


" 


4D 


M 


78 


X 


23 


# 


4E 


N 


79 


y 


24 


$ 


4F 


O 


7 A 


z 


25 


% 


50 


P 


7B 


{ 


26 


& 


51 


Q 


7C 


} 


27 


' 


52 


R 


7D 




28 


( 


53 


S 


7E 


^ 


29 


) 


54 


T 


7F 


DEL 


2A 


* 


55 


U 








EXTENDED 
MONITOR 

(0 



!BEA5 



IRE EM 

Transfer of Control Commands 



ASSEMBLER 

(♦) 



OS-65D 

DISK OPERATING SYSTEM 




BASIC 



" i, 



DOS 



EXTENDED 
MONITOR 




ASSEMBLER 



DOS and BASIC 

QUICK 
REFERENCE 



TO START YOUR COMPUTER 

Check to make sure no diskettes are in the disk 
drives!! Lock the SHIFTLOCK or ALL CAPS key. 

1. Turn on the computer, disk drives and terminals 

-switches are generally located on the back of the 

device cabinet. 
2'. Place an OS-65D disk in drive A (the drive whose red 

light is on or the top drive in dual drive cabinets). 

Close the disk drive door. 

3. Depress the BREAK key on C1P and C4P systems 
(and hold for a few seconds). Depress the white reset 
button on C8P and serial systems. 

4. When the "H/D/M?" ("D/C/W/M?" on C1P systems) 
message appears, respond by typing "D". In a few 
seconds a menu should appear on the screen. 

5. To enter the BASIC immediate mode, respond 
UNLOCK to this menu in OS-65D V3.2; select option 9 
in OS-65D V3.3. 



65D BASIC 



The entries are organized alphabetically according 
to Keywords used. Each entry consists of the general 
syntax, examples where appropriate, and a brief 
description. 

The following notation is used: 

see page n of the OS-65D Tutorial and 

Reference Manual 
see page n of the OSI BASIC Reference Manual 
cannot be used in the immediate (direct) mode; 

must be used with a program statement number, 
can only be used in the immediate (direct) mode; 

must not be used within a program, 
not available under OS-65D V3.3. 
available only under OS-65D V3.3. 
a numeric constant or arithmetic expression (see {3}) 
a logical constant or relational expression (see {4}) 
a string constant or expression (see {4}) 
a 65D Disk Operating System (DOS) command, 
a constant or expression, 
a variable 
a constant 
a numeric variable 
an integer variable 
a string variable 

a numeric variable or integer variable 
a relational expression or arithmtic expression 
a disk file name 
a memory location address 
a program statement number 
ah OS-65D device number. [54] 



DATA 



DEFFN 



[n] 

{n} 

(*) 

(**) 

(2) 

(3) 

ae 

re 

se 

dos 

e 

V 

c 

nv 

iv 

sv 

niv 

rae 

FILE 

loc 

sn 

dev 

ABS 

AND 



ASC 

ATN 
CHR$ 

CLEAR 
CLOSE 
CONT 

COS 



DIM 



DISK! 



DATA c, c, C, ... 

DATA 1.7, "BIG", 173,-812 
Establishes a list of constants to be 
input by the program via the READ 
statement {6} 

DEF FNnv(nv) = ae 

DEFFNA(X) = X*7 + 3 
Defines a single variable function for 
future use within the program segment 
{23} (*) 

DIM v(ae, ae,. ..),... 

DIM A(20), B$(6,7) 
Declares the variables specified to be 
subscripted. {18} 



ABS(ae) 

A function. Returns the absolute value of 

its argument. {19} 

re AND re 

IFX<15 AND X>=0 THEN 100 
A bitwise Boolean AND operator . re 
AND re will be TRUE only when both of 
the operands have the value TRUE. {4} 
ASC(se) 

ASC(X$) ASC("BIG") 
A function. Returns the ASCII value in 
decimal of the first character in the 
argument {20} 
ATN(ae) (-1< ae< 1) 

ATN(0.431) 
A function. Returns the arctangent of 
the argument {20} (2) [188] 
CHR$(ae) (0«ae<255) 

CHR$(66) 
A function. Returns the character whose 
decimal ASCII value is the greatest 
integer less than or equal to the 
argument. {21 }. 
CLEAR 

Clears the program variable table and 
restores the data pointer {*) {17} 
DISK CLOSE, dev (dev =6 or dev = 7) 
Closes a disk file that has been 
previously opened. {28}, [15] 
CONT 

Restarts a program whose execution has 
been interrupted by a STOP or END 
statement or a CTRL-C. {15} (**) " 
COS(ae) 

A function. Returns the cosine of the 
argument. {20} 



DISK! "dos" 

DISK! "IO 5,6" 

DISK! "LOAD FILE" 
Permits 65D DOS commands to be used 
within a BASIC program. [202] 

DISK CLOSE see CLOSE 
DISK FIND See FIND 
DISK GET See GET 
DISK OPEN See OPEN 
DISP PUT See PUT 

EDIT EDIT sn 

EDIT 100 

Returns line sn for editing. The short 
form is !sn. (**)[71] (3) 

END END 

Terminates program execution {13} 

EXIT EXIT 

Transfers control to the DOS mode {28} 

[53] 
EXP EXP(ae) ae< 88.029619 

EXP(41.662) 

A function. Returns e = 2.71828. ..raised 

to the power equal to the value of the 

argument. {19} 

FIND DISK FIND, se 

DISK FIND, "BIG" 
Beginning at current file pointer 
location, the data file is searched for the 
specified string, the pointer is set to the 
end of the field in which it is found. An 
unsuccessful search results in a #D 
error. [96] (3) 

FN See DEF FN 

FOR FOR nv = ae TO ae 

FOR nv = ae TO ae STEP ae 
FOR X = 15 TO 45 STEP 5 
Opens program loop. End of the loop is 
indicated by the statement NEXT or 
NEXT niv. STEP is used to define an 
increment other than 1 for niv for each 
iteration of the loop. In the example, the 
loop is executed 7 times {12} 

FRE FRE(X) X is a dummy variable 

A function. Returns the number of bytes 
of memory in the workspace that are 
unused. Save the program before using 
FRE. {17} 

GET DISK GET, niv 

DISK GET, 15 
Brings the record numbered niv from the 
disk to buffer #6 and sets the I/O 
pointers to the beginning of the record 
{28} [17] 



GOSUB GOSUB sn 

GOSUB 1000 
Program control is transferred to state- 
ment number sn. When the statement 
RETURN is encountered, control goes 
back to the statement following sn {23} 

GOTO GOTOsn 

GOTO 1000 
Program control is transferred to state- 
ment number sn. {11} 

IF IF rae GOTOsn 

IF rae THEN sn 

If the value of rae is TRUE (arithmetic 
expressions are considered to be TRUE 
if they have a value other than 0) 
program control is transferred to 
statement sn. 

IF rae THEN S (S is a program state- 
ment) 

If the value of rae is TRUE, statement S 
is executed {11 } 

INPUT INPUT V, V, ... 

INPUT X, Y, A$ 

Prompts for keyboard input to the 
specified variables {6} {* } 

INPUT# INPUT#dev, V, V, ... 

INPUT #6, A, B, Q$ 
Input is from device number dev to the 
specified variables. {9} [13] (*) 

INT INT (ae) 

INT (16.8) 
A function. Returns the greatest integer 
less than or equal to the argument {19} 

LEFTS LEFT$(se, ae) ae=>0 

LEFT$("ABCDE", 3) 
A function. Truncates ae to an integer 
and returns that leftmost number or 
characters from string se. In the 
example, "ABC" is returned. {21} 

LEN LEN(se) 

LEN(A$) 
A function. Returns the length of the 
string se {21} 

LET LET V = e 

LET A$ = "BIG" 
Assignment statement. Keyword LET is 
optional. {6} 

LIST LIST 

LIST sn-sn 

LIST 100-200 

LIST - 1000 

LIST 200 
Lists the program in the workspace 
between the two specified statement 
numbers. If the first (second) statement 
number is omitted, the default is the 
. beginning (end) of the program. {15} 

LIST# UST#dev 

LIST#4 
Same as LIST, but the listing is sent to 
device number dev. {9, 15} [54] 

LOG LOG(ae) ae>0 

LOG14.8 
A function. Returns the natural logarithm 
(log to the base e) of the argument. {19} 



MID$ 



NEW 



NEXT 
NOT 



NULL 



ON 



OPEN 



OR 



PEEK 



POKE 



POS 



PRINT 



PRINT# 



PRINT! 



MID$(se, ae, ae) first ae>0, second 
ae5-0 

MID$("ABCDEFG", 2, 3) 
A function. In the example, A string of 
length 3 starting at position 2 is 
returned; i.e. "BCD". If the second ae is 
omitted, the string returned goes to the 
end of se. {21} 

NEW 

Clears the workspace to prepare for 

creation of a new program {15} 

see FOR 

NOT re 

NOT (A > 5) 
A bitwise Boolean NOT operator. 
Reverses the truth value of the operand 
re. {3} 

NULL iv 0^iv«8 

Inserts iv zeros at the beginning of each 

line as it is stored on tape. {27} {2} 

ON ae GOTO sn, sn,... 
ON ae GOSUB sn, sn,... 

ON X + 7GOTO 100,200 
Depending upon the value of ae 
(truncated to an integer) program control 
passes to the ae-th statement in the list 
of statement numbers {12, 24} 

DISK OPEN, dev, "FILE" (dev = 6 or 7) 
Opens the disk file FILE for sequential 
(dev = 6 or 7) or random access (dev = 6 
only) {28} [15] 

re OR re 

IFA>5 0R A<2THEN 100 
A bitwise Boolean OR operator, re OR re 
is FALSE only when both of the 
operands are FALSE. {3} 

PEEK(loc) 

A function. Returns the value stored in 

memory location loc {25} 

POKE loc, ae 

POKE 11686, 17 
The value ae is stored in memory 
location loc {25} 

POS(X) X is a dummy variable. 
A function. In or following a PRINT state- 
ment, returns the current position 
(between and 132) of the cursor {9} 

PRINT e, e,... 

PRINT A, B$;C$ 
Outputs the values stored in the list of 
expressions. The keyword PRINT can be 
replaced by a question mark. {7} 

PRINT#dev, e, e,... 

Same as PRINT, but output is directed to 
device number dev instead of the screen. 
{7} [13] [54] 



ae is an integer. 



PRINTl(HOC), e, e,... (HOC = Hazeltine 

Operation code-see [223]) 
PRINT!(28) X$, A, B, C 
Depending on the value of HOC, certain 
screen characteristics and cursor 
positons are selected before beginning 
output of expression values; emulates 
certain Hazeltine terminal capabilities. 
[223] (3) 
PRINT CHR$ seeCHRS 



PRINT& PRINT&(X, Y), e, e,... 

PRINT&(10, 20) A, B$ 
Moves the screen cursor to screen 
position (X, Y) (0, = upper left corner) 
before beginning output of expression 
values. Identical to: 
PRINT!(17,X,Y), e, e,... [79] (3) 

PRINT USING PRINT USING se ae, ae, ... 

PRINT USING "####.##" 6.87304 
Used to format numeric output; se must 
be a string expression made up of a 
decimal point and/or #'s. In the example 
the output format specified results in 
printing 6.87 (with three leading blanks) 
[73] (3) 



PUT 
READ 

REM 

RESTORE 



RETURN 
RIGHTS 



RND 



RUN 



SGN 
SIN 



DISK PUT 

Follows a previous DISK GET; places the 

current record back to the disk. {28} [17] 

READ V, V, V,... 

READ A, B$, C 
Inputs constants that are specified by 
DATA statements in the same program 
into the specified variables {6} (*) 

REM any remark 

REM THIS IS A TEST PROGRAM 
Used for program documentation. Every- 
thing appearing after REM is ignored on 
execution of that line {16} 

RESTORE 

Resets the pointer in a program's DATA 

list to the first item. {7} 

See GOSUB 

RIGHT$(se, ae) ae>0 

RIGHT$("ABCDEF",2) 
A function. Truncates ae to an integer 
and returns that number of rightmost 
characters. In the example, "EF" is 
returned. {21} 

RND(ae) 

RND(-16) 
A function. Returns a number between 
and 1. Can be used repeatedly to 
generate a sequence of pseudo-random 
values. If ae> 0, the argument is a 
dummy argument. If ae= 0, RND 
returns the previous value again. If ae<0, 
ae functions as a "seed" and RND starts 
a new sequence. The sequence repeats 
after a certain period determined by the 
seed. {19} 
RUN 

Starts execution of the program in the 
workspace at the first statement. 
RUN sn 

Starts execution of the program in the 
workspace at statement number sn. 
RUN "FILE" 

Leads the program from disk file 
FILE and starts execution. 
RUN "TT" (TT = a disk track number) 
Loads the program from the disk file 
beginning at track TT and starts 
execution. {15} 
SGN(ae) 

A function. Returns +1 if ae > 0, if 
ae = 0, -1 if ae < {19} 
SIN(ae) 

A function. Returns the value of the sine 
of the argument ae. {20} 



SPC SPC(ae) 

PRINT "A"; SPC(5); "B" 
A function. Used to print ae spaces in a 
PRINT sequence {9} 

SQR SQR(ae) ae=s0 

A function. Returns the square root of 
the argument ae. {20} 

STEP See FOR 

STOP STOP 

Halts execution of a program and prints 
a BREAK message indicating the state- 
ment number of the STOP statement 
{13} 

STR$ STR$(ae) 

STR$(6.71) 
A function. Returns the value of the 
argument ae as a string. {21 } 

TAB TAB(ae) ae is an integer 

TAB(10) 
A function. Used in a PRINT statement 
to move the print position for the next 
character to position ae + 1 on the print 
line. {8} 

TAN TAN(ae) 

A function. Returns the tangent of the 
argument. {20} 

THEN See IF 

TO See FOR 

TRAP TRAP sn 

If an error is encountered in a program 
after this statement, then control 
transfers to statement sn. 
TRAP disables error trapping. [71] (3) 

USR USR(ae) 

Y = USR(X) 

Transfers control to a machine language 
routine at a location determined 
previously by appropriate POKES, ae 
may be an input parameter (and USR(ae) 
an output parameter) or ae may be a 
dummy parameter. {34} 

VAL VAL(se) 

VAL("6.31") 
A function. It is the opposite of STR$; 
returns the numeric value of the string 
expression se if se represents a number. 
Otherwise, is returned. 

WAIT WAITIoc, J 0^J<s255 

Halts program execution, Reads the 
contents of location loc and AND's the 
result (bitwise) until a nonzero result is 
obtained, then resumes program 
execution. 

WAITIoc, J, K 0^J, K<255 
Halts program execution, reads the 
contents of location loc, exclusive OR's 
that value (bitwise) with K, and then 
AND's the result with J until a nonzero 
result is obtained; then resumes 
execution {25} {2} 



SPECIAL V3.3 COMMANDS 
Screen Display Commands: 

(ESC) 1 Clears screen; homes cursor to upper left; 
produces "wide character" display 
(32x32 on C4P and C8P machines; 24x24 on 
C1P) 



(ESC) 2 



(ESC) 3 
(ESC) 4 

(ESC) 5 
(ESC) 6 
(ESC) 7 
(ESC) 8 

(ESC) 9 
(ESC) 10 



Clear screen; homes cursor; produces 
"narrow character" display 
(32x64 on C4P and C8P machines; 12x48 on 
C1P) 

Homes cursor to upper left 
Clears to end of screen (memory of work- 
space is not altered) 
Moves cursor up one line 
Moves cursor down one line 
Inserts line (lower lines scroll down) 
Clears line (memory of workspace is not 
altered) 
Turns color off 
Turns color on 



PRINT Statement Commands 

(These commands must be used in PRINT statements) 

Display Size 

!(20) Selects "wide character" display (32 x 32 on 

C4P and C8P, 12 x 14 on C1P), clears 
screen and homes cursor to upper left 
screen corner. 

!(21) Selects "narrow character" display (32 x 64 on 

C4P and C8P, 12 x 48 on C1P), clears 
screen, and homes cursor to upper left 
screen corner. 

!(22, w, h) Selects print window w characters wide 
and h characters high. Upper left window 
corner is at current cursor position; screen 
is not cleared. 

Cursor Control 

Single Step 

CH R$(8) Back one space. 
CHR$(16) Forward one space. 
!(12) Up one space. 

!(11) Down one space. 

CHR$(10) Down one space. 

Multistep 

CHR$(13) 
CHR$(14) 

Anywhere 

!(17, x, y) 
&(x, y) 

Home 

1(18) 



!(26) 



Line 

!(15) 
!(19) 
Screen 

!<24) 



Back to front of line. 

Forward to next eight space tab set 

(seven space for left-most field). 

Relocate to x, y (0 is upper left corner). 
Relocate to x, y (00 is upper left comer). 

Relocate to 0, (upper left corner). 

Insert 

Inserts line at cursor position; lower lines 
scroll down. 
Clear 

Clears from cursor to end of line. 
Clears entire line (lower lines move up). 



Clears from cursor to end (lower right) 

of window 
!<28) Clears entire screen and homes cursor in 

window. 
Color 
Color Select 

!(1) Selects color as cell background. 

!(25) Selects normal black/white display mode 

(i.e., black background, white character). 
!(31, n) Selects color n as cell background. 



Color Change 

!(2, n, m) Changes all displayed cells of background 
color m to background color n. 

!(29, n) Clears ail displayed cells of background 

color n (i.e., cell background is changed to 
black and character is replaced with a 
blank). 

Cursor Sensing 

!(5) Sends information for current cursor 

position x, y, to string variable in following 
INPUT statement. Information is in the 
form of two characters for which (x + 65) 
is the ASCII code. Line feed follows the 
INPUT statement used with !(5). 

!(33) Sends character at cursor position to 

string variable in following INPUT state- 
ment. Line feed follows the INPUT 
statement used with !(33). 



Printer Control 

!(67,FL) 
!(80) 



Initialize Epson Printer Drivers; set form 

length. 

Send Video Screen to Epson Printer 



** Note to Users of Serial Systems ** 

OS-65D V3.3 is only partially compatible with serial 
systems. If you are using a Hazeltine 1420 terminal, be 
sure switch 6 is set to the ESC position. Certain features 
that refer to color, screen size, or windowing are not 
operable on serial systems. Specifically, 

1) The commands that use the ESC key are not 
operable. 

2) The destructive backspace key is < DEL> 
instead of <SHIFT/0> or <RUBOUT> and the 
line delete is <@> instead of <SHIFT/P>. 

3) The PRINT command !{26) inserts a line but not 
at the cursor position. The line always starts at 
the left margin. 

4) The following PRINT commands should not be 
used: 



1(1) 
!(2,n,m) 
!(5) 
!(20) 



!(21) 
!(22,w,1) 
!(25) 
!(28) 



!(29,n) 
!(31,n) 
!(33) 



!(20) 

!(67,FL) 

!(80) 



V3.3 EDITOR COMMANDS 

(CTRL)H Moves cursor one space to the left 

(non-destructively) 
(CTRL)P Moves cursor one space to the right 

(non-destructively) 
(CTRL)F Moves cursor to the front of the line 
(CTRL)R Moves cursor to the rear of the line 
(CTRL)I Moves the cursor (non-destructively) 

forward to the next tab position 

(i.e., positions 1, 8, 15, 22, 29, 36, 43, 50 
57, 64, 71) 
(CTRL)T Retypes the line currently being edited 

(in its present edited form) 
(SHIFT)P Clears screen of line currently being edited 

leaving the line in workspace as it was 

before calling it to be edited 
(RUBOUT) Deletes the character flashing with the 

cursor. Line closes up from the right. 
EDITnn or Inn Calls line number nn for editing 
EDIT or ! Calls next line in program for editing 

EDIT! or !! Recalls last edited line for re-editing 



INDIRECT FILES 



To merge two BASIC programs 
using indirect files: 

1) determine the starting page 
number N of the indirect file, 

2) load one program into the 
workspace, 

3) move this program to the 
indirect file, 

4) load the second program into 
the workspace, 

5) move the first program back 
from the indirect file to the 
workspace. 

If each of the programs has a line 
with the same number the line in the 
first program will be the one that 
appears in the merged program. 

STARTING PAGE NUMBER 

OF INDIRECT FILE 

The starting page number N of an 
indirect file can usually be set at 128 
in OS-65D. If the program is quite 
large this value may not work. The 
indirect file must fit into memory 
above the program in the workspace. 
A value for N is given by: 

N = highest page in 

memory— pages unused in 
memory 

the highest page in memory can be 
obtained by: 

?PEEK(133) 
and the number of pages unused in 
memory can be obtained by 

?INT(FRE(X)/256), or 
if FRE(X) is negative, by: 

?INT((65536 + FRE(X))/256) 

The starting page of the 
workspace is approximately 

page 50 (317E) for OS-65D V3.2 on 

an 8 inch disk. 

page 51 (327E) for OS-65D V3.2 on a 

5 inch disk. 

page 59 (3A7E) for V3.3 systems 

(see p. 49 of 65D Reference Manual) 
The number of pages used by the 
program is: 

highest page — starting page — 

pages left. 
If the number of pages used exceeds 
the number of pages left there is not 
enough memory available to put this 
program in an indirect file. 

FROM WORKSPACE TO 
INDIRECT FILE 

To move a program from the 
workspace to an indirect file: 
1) enable the indirect file function 
with the following POKES, where N is 
the starting page number. 
POKE 9554.N 



2) LIST the program between 
square brackets as follows: With the 
program in the workspace, type 
LIST[< RETURN > 
(wait for listing to end) 
< SHIFT/M> < dt > < RETURN> 
If the keyboard is a polled keyboard 
use these commands instead: 

LIST <SHIFT/K> <RETURN> 

(wait for listing to end) 

< SHIFT7M > < @ > < RETURN > 

The first bracket "[" . < SHIFT/K> 

will not appear on the video screen. 

The second bracket appears twice as 

If the end of the listing appears 
garbled the indirect file was not 
placed high enough in memory and 
the end of the program in the 
workspace has been overwritten. 

FROM INDIRECT FILE TO 
WORKSPACE 

To move a program from an 
indirect file to the workspace: 

1) enter the appropriate POKEs, 
where N is the starting page number 
of the indirect file 

POKE 9368.N 

2) enter the command: 
<CTRUX> <RETURN> 

A listing of the program in the 
indirect file will appear ending with 
the bracket closure "]]". On some 
systems there will be a harmless 
error message before or after the 
listing. To see the contents of the 
workspace enter the command LIST. 

MOVING PROGRAMS 

BETWEEN INCOMPATIBLE 

DISKS 

To transfer a program between 
incompatible disks: 

1) determine the starting page 
number N of the indirect file, 

2) boot up BASIC and load the 
program into the workspace, 

3) move the program to the indirect 
file using the POKEs tor the system 
on this disk, 

4) boot up BASIC on the other disk: 
clear the workspace with NEW, 

5) move the program from the 
indirect file to the workspace using 
the POKEs for the system on this new 
disk, 

6) PUT the program on the new 
disk. 

(for additional details, see chapter 12 
of the BASIC Reference Manual) 



UTILITY PROGRAMS 

A brief description of the utility program supplied with the OS-65D 
system (operating system restrictions are in parenthesis). 



ASAMPL 
ATNENB 



BEXEC* 
BUFFER 



- Sample Assembly language program 

- Enables or disables arc tangent and print extensions 
(V3.3 oniy) 

- Program which is run upon boot-up; displays menu. 

- Check the size of program buffers; add and defte 
buffers. (V3.3 only - Disk 2) 



CHANGE 



COLORS 
COM PAR 
COPIER 
CREATE 

DATRAN 
DELETE 
DIR 
DISASM 

GSOSRT 

MODEM 

RANLST 
RENAME 
REPACK 

RSEQ 

SECDIR 
SEQLST 
TRACE 
ZERO 



- Permits adjustment of the following: 

- Terminal width for BASIC. 

- The highest page of memory available which is 
what BASIC and ASM use when loaded. 

- The adjustment of the workspace limits for BASIC. 
The result is an empty workspace to the user 
specifications. 

- Color adjustment program. 

- Utility for comparing diskettes. (V3.3 only) 

- Utility for copying diskettes. (V3.3 only) 

- Enter a file name into the directory and zero out the 
created file on disk. 

- copy data files. (V3.3 only - Disk 2) 

- Remove a file name from directory. 

- Print unsorted disk directory. 

-Generate an assembly language listing for machine 

code program. (V3.3 only - Disk 2) 
-Sort data files, including MDMS master files. (V3.3 only 

- Disk 2) 

- Sets up a machine code modem routine for use with a 
standard RS-232 modem, (V3.3 only). 

-General random access file list utility. 

- Rename a file name in directory. 

- Remove REM statements and blank spaces from BASIC 
program. (V3.3 only - Disk 2) 

- Change the numbering of statements in a BASIC pro- 
gram. (V3.3 only - Disk 2) 

- Print a sector map directory of disk. 

- General sequential file list utility. 

- Enable or disable statement number trace feature. 

- Initialize contents of a data file to zeros. 



HEX 
Top of Memory 



SYSTEM MEMORY MAPS 

V3.2 8" V3.3 5" V3.3 i 



4A7E 
497E 
467E 



30 n 
3A7E 



2A4B 
26bC 



Maximum of 5 pages (or V3 3 editor or 
Optional Utilities. Sutler Creator or Resequencer 



0S-65D DOS 
Extensions 
PAGE 8/ 1 Swapper 
Difectory Workspace File Header Information 



OS-650 DOS Kernel 



OS-65D DtsKelle Drivers 



OS-65D I/O Routines 



Qlner Language Processor 



Decimal 

Top of Memory 



59070 



11897 

m?7 

9820 
6968 



(Dark line indicates Normal Stan of workspace) 



POKE AND PEEK LIST 

As systems develop, different locations are committed to 
hold parameters. Many of these parameters have been 
mentioned in the text material. These parameters are collected 
here, along with some other useful parameters which may be 
needed by an advanced programmer. Users of the video systems 
and systems that include certain options and accessories (e.g., 
Home Security, Remote Control, High Resolution Graphics, etc.) 
may need to POKE or PEEK other parameter locations.These 
locations are fully documented in the appropriate User's 
Manuals. CAUTION: Care must be taken when POKEing any of 
these locations to avoid system errors. 

LOCATION CONTENTS 
DECIMAL HEX (DEC) COMMENTS 

23 17 132 Terminal width (number of printer 

characters per line). The default value is 
132. Note, this is not to be confused 
with the video display width (64 
characters). 



LOCATION CONTENTS 
DECIMAL HEX (DEC) 



COMMENTS 



24 18 



120- 78— 

121 79 



741 2E5 



750 
1797 

2073 

22W 
2888 



2EE 
785 

819 

898 
B48 



2893 B4D 

2894 B4E 



2972 



2976 



B9C 



BA0 



112 Determines the number of (14 character) 
output fields in a terminal output line 
when outputting BASIC variables 
separated by commas. As long as the 
contents of this location exceeds the 
current terminal output position, the 
terminal output line will continue with a 
tab to the start of the next output field. 



127 
50 



10 



10 



Lo-Hi byte address of the beginning 
of BASIC work space (note 127 = $7F, 
50 = $32). 

Normal contents of Location 121 is 58 
on V.3.3 and 49 on Serial Systems. 

Control location for "LIST." Enable with 
a 76, disable with a 10. 

Control location for "NEW." Enable with 
a 78, disable with a 10. 

32 Controls line number listing of BASIC 
programs, enable with a 32, disable with 
a 44. 

173 "CONTROL C" termination of BASIC 
programs. Enable with 173, disable with 
96. 

Track ' 
(Load address.) 
27 A 27 present here allows any null input 
(carriage return only) to force into 
immediate jumping out of the program. 
Disable this with a 8. Location 8722 
must also be set to 0. 

55 Alternate "break on null input" 
enable/disable location, (see 2894) 

08 A null input will produce a "REDO 

FROM START" message when 2893 and 
2894 are POKEd with 28 and 11 
respectively. 

58 Normally a comma is a string input 

termination. This may be disabled with a 
13 (see 2976). 



87*8 


2204 


41 


8722 


2212 


27 


6902 


22C6 


00 


8917 


22D5 






44 A colon is also a string input terminator, 
this is disabled with a 13 (see 2972, 9976) 

Output flag for peripheral devices. 
Null input if = 00, normal input if = 27. 
Determines which registers (less 1) 
RTMON scans (HC systems only). 

USR (X) Disk Operation Code: 
0-write to Drive A 
3-read from Drive A 
6-write to Drive B 
9-read from Drive B 

8954 22FA — Location of JSR to a USR function. 

Present to JSR S22D4, i.e., set up for 
USR (X) Disk Operation. 

8960 23(80 - Has page number of highest RAM 

location found on OS-65D's cold start 
boot in. This is the default high memory 
address for the assembler and BASIC. 

8993 2321 — I/O Distributor INPUT flag 

8994 2322 — 1/0 Distributor OUTPUT flag 

8995 2323 — Index to current ACIA on 550 board. If 

numbered from 1 to 15 the value POKEd 
here is a 2 times the ACIA number. 

8996 2324 — Location of a random number seed. This 

location is constantly incremented 
during keyboard polling. 



(Note: Locations 8998 through 9005, 9132-9133, and 9155-9156 are used 
for Disk Buffer #6 (I/O Flag Bit 5 device) usage parameters.) 
126 LO-HI byte address for the start of 
" Buffer #6 ('contents vary: 58 on all V3.3: 
50 on 5" V3.2; 49 on 8" V3.2) 

126 LO-HI byte address for the end of 
' Buffer «6 ('contents vary: 66 for 5" V3.3: 
70 for 8" V3.3; 58 for 5" V3.2; 61 for 8" 
V3.2) 

— First track of Buffer #6 File (BCD) 

— Last track of Buffer m File (BCD) 

— Current rack in Buffer #6 (BCD) 

— Buffer *6 Dirty Flag (if contents is non- 
zero, then data has been written to the 
buffer, but has not yet been transferred 
to the disk) 

(Note: Locations 9006 through 9013, 9213-9214, 9238-9239 are used for 
Disk Buffer #7 (I/O Flag Bit 6 device) usage parameters) 



8998- 
8999 


2326- 
2327 


9000- 
9001 


2328- 
2329 


9002 


232A 


9003 


232B 


9004 


232C 


9005 


232D 



9006- 
9007 


232E- 
232F 


9008- 
9009 


2330 

2331 


9010 


2332 


9011 


2333 


9012 


2334 


9013 


2335 


9098- 
9099 


238A- 
238B 


9105- 
9106 


2391- 
2392 


9132- 
9133 


23AC- 
23 AD 


9155- 
9156 


23C3- 
23C4 


9213- 
9214 


23FD- 
23 FE 


9238- 
9239 


2416- 
2417 



126 



9368 



9682- 
9683 



9770 



25D2- 
25 D3 



262A 



9796 


2644 


9822 


265D 


9823 


265 F 



9824 



2660 



26F8 



126 



126 



126 



11511 


2CF7 


— 


12076 


2F2C 


— 


12042 


2F0A 


- 


13026 


32E2 


171 


13743 


35AF 


32 



LO-HI Byte address for the start of 
Buffer #7 ('contents vary: 58 on 5" 3.2; 
61 on 8" V3.2; 66 on 5" V3.3; 70 on 8" 
V3.3) 

LO-HI Byte address for the end of 
Buffer #7 ('contents vary: 66 on 5" V3.2; 
73 on 8" V3.2; 74 on 5" V3.3; 82 on 8" 
V3.3) 

First track of Buffer #7 File (BCD) 

Last track of Buffer #7 File (BCD) 

Current rrack in Buffer #7 (BDC) 

Buffer #7 Dirty Flag (0 = Clean; 
see comment for location 9005) 

Pointer to Memory Storage Input 
(Lo and Hi Byte). 

Pointer to Memory Storage Output 
(Lo and Hi Byte). 

LO-HI Byte address of Buffer #6 
current input. (* 50 on 5" V3.2; 49 on all 
other systems) 

LO-HI Byte address of Buffer #6 
current output. (*50 on 5" V3.2; 
49 on all other systems) 

LO-HI Byte address of Buffer #7 
current input. ('62 on 5" V3.2; 
61 on all other systems) 

LO-HI Byte address of Buffer #7 
current output. ('62 on 5" V3.2; 
61 on all other systems) 

Indirect File Input Address (Hi Byte) 
(Lo = 00) 

Pointer to Indirect File (Hi Byte only) for 
output (Lo = 00) 

Next Position for Cursor on video 
screen (HI and LO Bytes) V3.2 Video 
Systems only) 

Display control parameters. Single 
Space = 64; Double Space = 128; (V3.2 
Video Systems only) 

Entry point to Keyboard Swap Routine 

Sector for USR(X) on Disk. 

Page Count for USR(X). 
Read or Write. 

Pointer to memory for USR(X). 

(Lo and Hi Bytes) USR(X) will reside in 

location pointed to. 

Contains track number for USR(X) on 

disk (Decimal) 

Disable ":" Terminator. See Location 
2976 comments. 

Console terminal number. (*1 on Serial 
Systems; 2 on Video Systems) 

Page 0/1 Swap Address 

Sets record length for data file use 

Sets Number of records per track for 
data file use. 

Selects cursor character (V3.3 only) 

Selects Flashing cursor; 44 selects 
non-flashing cursor. (V3.3 only) 



ERROR MESSAGE CODES 

1 - Can't Read Sector (Parity Error). 

2 - Can't Write Sector (Reread Error). 

3 - Track Zero is Write Protected Against that 

Operation. .^ 

■4 - Diskette is Write Protected. 

5 - Seek Error (Track Header Doesn't Match'Track). 

6 - Drive Not Ready. 

7 - Syntax Error in Command Line. 

8 - Bad Track Number. 

9 - Can't Find Track Header Within One Rev. of 

Diskette. 
A - Can't Find Sector Before One Requested. 
B ■ Bad Sector Length ?alue. 
C - Can't Find that Name tn Directory, ■.«.-,■ ; 

D • Read/Write Attempted Past End of Named File. 

BASIC ERROR MESSAGE CODES 

BS Bad subscript: Matrix outside DIM statement 
range, etc. 

CN Continue Errors: Attempt to inappropriately con- 
tinue from BREAK or STOP. 

DD Double Dimension: Variable dimensioned twice. 
Remember, subscripted variables default to 
dimension 18. 

FC Function Call Error: Parameter passed to 
function out of range. 

ID Illegal Direct: INPUT and DEF statements can- 
not be used in direct mode. 

LS Long String: String longer than 255 characters; 

NF NEXT without FOR. 

OD Out of Data: More reads than data. 

OM Out of Memory: Program too big or too many 
QOSUBs, FOR-NEXT loops or variables. 

OV Overflow: Result of calculation too large. 

RG RETURN without GOSUB. 

SN Syntax Error: Typo, etc. 

ST String Temporaries: String expression too 
complex. **» : 

TM Type Mismatch: String varfOTte mismatched to 

numeric variable. »4f ' „ 

UF Undefined Function. 'Sffir * 

US Undefined Statement: Attempt to jump toVion- 
existent line number. 

19 Division by Zero. 

OS Out of String Space: Same as OM. 



ASM 



BASIC 
CALLNNNN = TT,S 

D9 

DIRTT 

EM 

EXAM NNNN=TT 

GONNNN 
HOME 

INIT 

INITTT 
IONN.MM 

10, MM 

10 NN 

LOAD FILNAM 

LOADTT 

MEMNNNN.MMMM 

PUT FILNAM 

PUTTT 

RET ASM 
RET BAS 
RET EM 
RET MON 

SAVETT,S = NNNN/P 
SELECT X 

XQT FILNAM 

XQTTT 



DOS COMMANDS 



Load the assembler and extended 
monitor. Transfer control to the 
assembler. 

Load and transfer control to BASIC 
Load contents of Track "TT", sector 
"S" to memory location "NNNN". 

Disable error 9. This is required to 
read some earlier version files (V1.5, 
V2.0). (on 8" systems only) 
Print sector map directory of track 
"TT". For each sector, the number of 
pages is given. 

Load the assembler and extended 
monitor. Transfer control to the 
extended monitor. 

Examine track. Load entire track 
contents, including formatting 
information, into location "NNNN". 
Transfer Control (GO) to location 
"NNNN". 

Reset track count to zero and HOME 

the current drive's head to track 

zero. 

INITIALIZE the entire disk. I.e. erase 

the entire diskette (except track 0) 

and write new formatting 

information on each track. 

Same as "INIT", but only operates 
on Track "TT". 

Changes the Input I/O distributor 
flag to "NN", and the Output flag to 
"MM". 

Changes only the Output flag. 
Changes only the Input flag. 

Loads named source file, "FILNAM", 
into memory. 

Loads source file into memory given 
starting track number "TT". 

Sets the memory I/O device Input 
pointer to "NNNN", and the Output 
pointer to "MMMM". 

Saves source file in memory on the 
named disk file "FILNAM". 

Saves source file in memory on 
track "TT" and following tracks. 

Restart the assembler. 

Restart Basic. 

Restart the extended monitor. 

Restart the Prom monitor (via 

RSTVECTOR). 

Save memory from location "NNNN" 

on track "TT sector "S" for "P" 

pages. 

Select disk drive "X" where "X" can 

be; A, B, C, or D. Select enables the 

requested drive and homes the head 

to track ft 

Load the file, "FILNAM" as if it was 

an object file, and transfer control to 

location $3A7E 

(31 7E on 8"V3.2; 327E on 5" V3.2) 

Load the file beginning on track 

"TT" as if it was an object file and 

transfer control to location $3A7E 

(31 7E on 8" V3.2; 327E on 5" V3.2) 



A Jl^Qfvi COMPANY 

OHIO SCIENTIFIC, IMC. 

1333 & ClflLLCOTHE ROAD 
• AKCm CMOMX3Q 



NOTES: 

—Only the first 2 characters are used in recognizing a DOS 
command. The rest up to the blank are ignored. 

—Commands can be used in the baisc mode in the form 
DISK! "DOS" where DOS represents one of the commands 
above. 

—All memory locations should be in hex. 



